home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
User's Choice Windows CD
/
User's Choice Windows CD (CMS Software)(1993).iso
/
win_m_p
/
mbar.zip
/
MENUBAR.TXT
< prev
next >
Wrap
Text File
|
1992-02-25
|
16KB
|
402 lines
MENUBAR Toolbar Program
Users manual
Release 1.00
February 28, 1992
Copyright (c) 1992
by
MRL
1200 Stonehurst
Huntsville, Alabama 35801
All Rights Reserved
This file provides the information needed to utilize the shareware
distribution version of the MENUBAR program. MENUBAR is a
copyrighted product of MRL and all rights are reserved. Any and all
usage must be in accordance with terms discussed in section III of
this documentation. No usage other than for evaluation is permitted
without registration. User feedback including comments/questions
are welcome. Please address your comments to MRL via Compuserve
electronic mail at user id [73637,737] or via mail to 1200
Stonehurst, Huntsville, AL., 35801.
Restrictions and Warranties
The software described herein is furnished under a license
agreement. The software may be used or copied only in accordance
with the terms of the applicable agreement. The purchaser may make
one copy of the software for backup purposes. Unregistered copies
of MENUBAR are for evaluation purposes only, and may be distributed
through normal shareware channels. Please distribute these
evaluation copies to other bulletin boards and users. MENUBAR may
be uploaded to and downloaded from commercial systems such as
CompuServe, the Source, and BIX, as long as there is no charge for
the product itself. Those copying, sharing, and/or electronically
transmitting this product are required not to delete or modify the
copyright notice and restrictive notices from the program or
documentation. Any distribution of MENUBAR must include all files
contained in the packed format. Commercial vendors and distributors
of "public domain" or user-supported software libraries may
distribute copies of MENUBAR unless notified by MRL to cease
distribution of the product. Only nominal fees associated with
copying and handling (not to exceed $5 US) may be charged by anyone
providing unregistered copies. MENUBAR may not be utilized or
distributed as a promotion for any commercial venture.
Information in this document is subject to change without notice
and does not represent a commitment on the part of MRL.
To use MENUBAR, you need the following:
IBM PC (or compatible)-286 with 1 Mbyte.
Microsoft Windows (version 3.0 or later)
MS-DOS/PC-DOS (version 3.0 or a later version required
by your version of Microsoft Windows)
Use of this product for any period of time constitutes your
acceptance of this agreement and subjects you to its contents.
EXCEPT AS PROVIDED IN PART III OF THIS MANUAL, MRL DISCLAIMS ALL
WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED
TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT. SHOULD THE PROGRAM
PROVE DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE
ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND
ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES. IN NO EVENT WILL MRL BE
LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION
DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS
OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE
INABILITY TO USE THIS PRODUCT.
I. CONCEPT
MENUBAR may be utilized with MS Windows to customize the user
environment by addition of menubars (or toolbars) that specify a
user selected icon/bitmap file and associate this file with an
executable programs. MENUBAR provides a capability to define
toolbar controls that augment existing execution methods or create
a complete desktop environment based on the users own preferences.
II. Specification of Options
This section describes how the user creates and selects the MENUBAR
capabilities. Three command line functions are described in the
following sections, with the additional sections describing the
dialogue interaction necessary to edit or create a menubar and
mouse/key usage.
1.0 Execution of an existing menubar definition.
The user may execute a previously defined menubar definition by
providing the definition name as the first parameter of the command
line. Note that each menubar definition is stored as a separate
MSDOS file. If the user does not specify the MSDOS filename
extension, MENUBAR creates this with the extension .mbr. The
command to execute an existing definition is menubar xxx, where xxx
is the menubar definition name. xxx must conform to the filename
portion of the MSDOS naming conventions. When utilizing Program
Manager for execution, it is recommended that the pathname be
included as part of both the program name and definition name. For
example "c:\menubar\menubar.exe c:\data\menu1" would execute the
MENUBAR program from directory c:\menubar and use the menu1
definition form the MSDOS file c:\data\menu1.mbr. The default
pathname for bitmap/icon files is the pathname provided for the
definition file.
To utilize a menubar as part of windows startup, the win.ini file
should be modified as follows:
1) Add to Extensions section mbr=xxx\menubar.exe yyy\^.mbr
where xxx is the MENUBAR program directory and yyy is the directory
containing the .mbr files.
2) Add to Windows section run=xxxx.mbr
where xxxx is the desired menubar name.
MENUBAR is not configured to replace the Windows program manager.
2.0 Creating a new menu definition.
The user creates a new definition file by entering the menubar
command without any parameters. A Message Box will confirm that
this was the intended action, and then a data dialogue will be
provided for entry of the definition name. The detailed definition
dialogues (see section 4.0) are then provided for specification of
the characteristics.
3.0 Editing an existing definition
The user may edit an existing definition by specifying the -E
parameter followed by the definition name. For example
"menubar -E menu1" would edit the menu1.mbr file in the current
directory. The detailed dialogues (see section 4.0) are displayed
to allow for changing the current characteristics.
4.0 Detailed characteristics
This Section describes three detailed dialogues for definition of
the menubar. The Menubar dialogue provides for definition of all
parameters and selection of individual command sets for
modification or deletion. The command set dialogue allows for
specification of the bitmap/icon file, the command and associated
parameters. The file open dialogue allows for file selection.
4.1 Menubar dialogue
The fields on this dialogue allow for complete definition of a
single menubar. They include size, position, number of items per
row, and close options. Individual commands activate the command
set dialogue or operate on command sets.
4.1.1 ROW
Entry to this edit box is the row location in pixels of the upper
left hand corner of the menubar.
4.1.2 COLUMN
Entry to this edit box is the column location in pixels of the
upper left hand corner of the menubar.
4.1.3 HEIGHT
Entry to this edit box is the height in pixels of the menubar. This
is a function of the number of rows of bitmaps/icons planned and
the size of the icons. Bitmaps are sized within a part of the
menubar. Icons are truncated if the size is insufficient. This size
should be specified as (desired height of bitmap/icon+1)*(Number
of rows)+9. If this field is omitted, MENUBAR calculates the height
based on an individual bitmap/icon size of 32 pixels.
4.1.4 WIDTH
This edit box is the width in pixels of the menubar. This is a
function of the number of bitmaps/icons planned for a row and the
size of the icons. Bitmaps are sized within a part of the menubar.
Icons are truncated if the size is insufficient. This size should
be specified as (desired width of bitmap/icon+1)*(Number of items
per row)+9. If this field is omitted, MENUBAR calculates the width
based on an individual bitmap/icon size of 32 pixels.
4.1.5 Items per row
This edit box is the is the number of bitmaps/icons to place on
each row. This is a required field. Multiple rows are created when
the number of command sets exceeds this value.
4.1.5 Close Menu
Selection of this button indicates that the menubar is to be closed
after execution of a valid command.
4.1.6 Command Sets
This list box displays the currently defined command sets. Each set
is described in terms of the bitmap/icon file name, followed by the
command file and parameters. Individual actions against command
sets are at the bottom of the list box are discussed below.
4.1.6.1 ADD command
This button activates the command set dialogue to create a new
command entry following the currently selected entry in the list
box.
4.1.6.2 MODIFY command
This button activates the command set dialogue to modify the
currently selected entry in the list box.
4.1.6.3 DELETE command
This button deletes the currently selected entry in the list box.
4.1.6.4 CANCEL command
This button exits the edit/create processing without changing the
definition.
4.1.6.5 OK command
This button exits the edit/create processing after changing the
definition.
4.2 Command Set dialogue
The command set dialogue contains fields to modify/create an
individual command set consisting of a bitmap/icon file, a command
file, and a set of parameters. Select buttons are provided to
utilize the file open dialogues for selecting the files.
4.2.1 Bitmap/Icon file
Entry to this edit box specifies the graphic file name to be
displayed as the command identification on the menubar. This may
be a standard windows icon (.ICO) or bitmap (.BMP) file. The SELECT
button may be utilized to display the file selection dialogue for
specifying the filename.
4.2.2 Command
Entry to this edit box specifies the command to be executed by
selection on the menubar. This may be any executable file that may
be run under windows. The SELECT button may be utilized to display
the file selection dialogue for specifying the filename.
4.2.3 Parameters
Entry to this edit box is for specification of the parameters
associated with the command to be executed. The shareware version
only allows for specification as part of the menubar definition.
4.2.4 Select
This button is utilized to display the file selection dialogue for
specifying any filename.
4.3 File Select Dialogue
This dialogue allows for selection of a file by browsing through
directories and/or specification of portions of the filename. A
default extension and prompt is provided for each type of file.
5.0 Mouse/key Usage
The user may utilize either a mouse or the keyboard to execute
commands, minimize the menubar or close the menubar.
When using the mouse, three actions occur as a result of the mouse
(left button) being clicked depending on the selection made.
Selecting a bitmap/icon executes the command. Selecting the menubar
border or any selection with the SHIFT key depressed closes the
menubar. Any selection with the CONTROL key depressed minimizes the
menubar. If the bar is minimized, a double click restores it to the
original position.
Alternately, the keyboard may be utilized. The ARROW keys are
utilized to select individual command sets. Entry of a SPACEBAR or
ENTER key executes the selected command. The ESCAPE key terminates
the menubar.
III. REGISTRATION AND LICENSE FEES
MENUBAR must be registered if utilized for other than
evaluation purposes for a period not to exceed thirty (30) days.
A separate copy is required for each PC utilized. The file
menubar.frm provides a sample form to be printed and included with
payment or send your name, company, and address to MRL, 1200
Stonehurst Drive, Huntsville, Al, 35801. Registration using VISA/MC
may also be accomplished by transmitting this form using Compuserve
electronic mail to MRL at user id [73637,737].
Registration provides you with a version that includes the
following:
- No startup or periodic messages
- Hardcopy users manual
- Additional program features including user parameter
input at execution.
- 90 day free consultation support
- Mailing list distribution of upgrades and new products
*****************************************************************
This program has been developed and tested for Windows 3.0.
Although Windows 3.1 is widely distributed, testing of MENUBAR on
3.1 has not been accomplished as of March 1, 1992. Should an update
be required to execute under Windows 3.1 all registered users will
receive this update free of charge. Delivery is dependent on
availability of 3.1 software developers kit.
*****************************************************************
1. Registration Costs
Current rates for prepaid orders (in US dollars) are as follows:
$24.95 Single user registration/license fee.
$1.00 Additional cost for 3.5 disk.
$5.00 Per Order Shipping and Handling fee.
$3.00 MC/VISA usage handling fee.
$10.00 Purchase Order Handling (under $100.). Subject to Company
approval.
Residents of Alabama and Huntsville must add appropriate Sales
Tax.
The scheduled rates and charges are current as of the date of
this manual. All fees and charges are subject to change without
notice.
Multiple Purchase registrations are available pursuant to the
following schedules.
Total Copies Registered (on one order) Percent Discount
------------ ------------
1 to 5 0%
6 to 10 15%
10 to 99 30%
100 to 499 40%
500 to 999 50%
1000 or more 60%
As stated herein, there are no warranties whatsoever associated
with the MENUBAR software product, and MRL is not responsible for
its performance. You are the sole judge of the product's
effectiveness and suitability for your particular purposes, and are
given an opportunity to evaluate same via shareware distribution.
We can only accept drafts, checks, international money orders or
travelers checks payable in U. S. dollars drawn on U.S. banks.
Registration can also be paid by credit card, Visa or Master Card.
Registered users will be notified when updates and new products
are available. Anyone wishing to offer advice and suggestions
are most welcome to do so.
Questions, errors, and suggestions for product improvements are
welcome, either mail these to MRL, 1200 Stonehurst Drive,
Huntsville, AL, 35801 or transmit them via Compuserve electronic
mail to MRL at user id [73637,737].
Compuserve electronic mail is the quickest method of receiving
response. Be sure to include:
- The version of the copy of MENUBAR that you are using.
- DOS and Windows versions that you are using;
- hardware configuration (model, memory size, printer, etc.)
- Windows or standard DOS applications that you may be running
or have loaded under Windows at the same time.